Saltar al contenido principal

Configuración de TCP Communication

Esta guía le muestra cómo configurar la comunicación TCP entre su cámara OV20i y dispositivos externos utilizando Node-RED. Utilice la comunicación TCP para intercambio de datos en tiempo real, control remoto o integración con aplicaciones y sistemas personalizados.

Cuándo usar la Comunicación TCP: Transmisión de datos en tiempo real, integración con aplicaciones personalizadas, comunicación bidireccional con sistemas externos, intercambio de datos de alta frecuencia, o cuando las APIs HTTP/REST no sean adecuadas.

Prerrequisitos

  • Sistema de cámara OV20i configurado y conectado
  • Dispositivo/sistema de destino con capacidad de comunicación TCP
  • Conectividad de red entre la cámara y el dispositivo de destino
  • Comprensión básica de direcciones IP y números de puerto
  • Receta activa configurada (configuración de imágenes e inspección completa)

Paso 1: Verificar la Configuración de Red

1.1 Verificar la Dirección IP de la Cámara

  1. Navegar a Configuración del Sistema
  2. Anote la dirección IP de la cámara (p. ej., 192.168.0.100)
  3. Verifique la máscara de subred y la configuración de red

1.2 Confirmar Red del Dispositivo de Destino

Garantizar compatibilidad de red:

  • Misma subred: La cámara y el dispositivo de destino deben estar en el mismo rango de red
  • Puertos accesibles: Los puertos del dispositivo de destino no deben estar bloqueados por firewalls
  • Conectividad de red: Probar con el comando ping si es posible

1.3 Requisitos de Red

RequisitoCámaraDispositivo de DestinoNotas
Rango IP192.168.0.100192.168.0.xxxDebe ser la misma subred
Máscara de Subred255.255.255.0255.255.255.0Configuración estándar
Acceso al Puerto49155 (ejemplo)49155 (ejemplo)Evite puertos reservados
FirewallPermitir tráfico TCPPermitir tráfico TCPAmbas direcciones

Paso 2: Acceder al Editor de Node-RED

2.1 Navegar al IO Block

  1. Haga clic en "IO Block" en el menú de migas de la receta, O
  2. Seleccionar "Configure I/O" desde el Editor de Recetas

2.2 Abrir Editor de Node-RED

  1. Haga clic en Configure IO para ingresar al editor de flujo de Node-RED
  2. Verifique que la interfaz de Node-RED se cargue correctamente

Punto de control: Debe verse el editor de flujo de Node-RED con la paleta de nodos a la izquierda.

Paso 3: Configurar Entrada TCP (Recepción de Datos)

3.1 Añadir Nodo de Entrada TCP

  1. Localice el nodo "tcp in" en el panel izquierdo (Sección Red)
  2. Arrastre el nodo "tcp in" al lienzo de flujo
  3. Haga doble clic en el nodo para configurarlo

3.2 Configuración de la Entrada TCP

Configuración del Nodo:

AjusteValorDescripción
TipoListen onLa cámara actúa como servidor
Puerto49155Puerto en el que escucha la cámara
Modo de datosStreamFlujo continuo de datos
Tipo de datosUTF8Comunicación basada en texto
Tema(opcional)Categorización de mensajes

3.3 Pasos de Configuración de Entrada TCP

  1. Configuración del servidor:
    • Seleccione "Listen on port" (modo servidor)
    • Ingrese número de puerto (p. ej., 49155)
  2. Manejo de datos:
    • Modo de datos: Seleccione "Stream" para datos continuos
    • Tipo de datos: Elija "UTF8" para texto o "Buffer" para binario
  3. Configuraciones avanzadas:
    • Carácter de nueva línea: Deje en blanco a menos que se requiera un delimitador específico
    • Tema: Identificador opcional de enrutamiento de mensajes
  4. Haga clic en Done para guardar la configuración

3.4 Guía de Selección de Puertos

Rango de PuertosUsoRecomendación
1-1023Reservados para el sistemaEvitar
1024-49151Puertos registradosVerificar disponibilidad
49152-65535Dinámico/PrivadosRecomendado

Paso 4: Configurar Salida TCP (Enviar Datos)

4.1 Agregar Nodo de Salida TCP

  1. Localice el nodo 'tcp out' en el panel izquierdo (sección Red)
  2. Arrastre el nodo 'tcp out' al lienzo del flujo
  3. Haga doble clic en el nodo para configurarlo

image.png

4.2 Configurar Ajustes de Salida TCP

Configuración del Nodo:

AjusteValorDescripción
TipoConectar aLa cámara actúa como cliente
Host192.168.0.200Dirección IP del dispositivo de destino
Puerto49155Puerto del dispositivo de destino
ModoClientConexión saliente

4.3 Pasos de Configuración de Salida TCP

  1. Configuración de Conexión:
    • Tipo: Seleccione "Connect to" (modo cliente)
    • Host: Ingrese la dirección IP del dispositivo de destino
    • Puerto: Ingrese el número de puerto del dispositivo de destino
  2. Opciones de Conexión:
    • Modo: Mantener como "Client"
    • Finalizar conexión: Configurar según el caso de uso
  3. Formato de Datos:
    • Base64: Usualmente desactivado para datos de texto
    • TLS: Activar solo si se requiere una conexión segura
  4. Haga clic en Done para guardar la configuración

Paso 5: Crear Flujo de Comunicación

5.1 Construir el Flujo Completo

Cree un flujo que pueda enviar y recibir datos TCP:

  1. Agregue estos nodos a su lienzo:
    • nodo Inject (para activar mensajes)
    • nodo Function (para procesamiento de mensajes)
    • nodo TCP Out (para enviar datos)
    • nodo TCP In (para recibir datos)
    • nodos Debug (para monitoreo)

5.2 Configurar Nodo Inject

  1. Haga doble clic en el nodo Inject
  2. Configurar ajustes:
    • Nombre: "Send Message" → Traducción: "Enviar Mensaje"
    • Carga útil: Marca de tiempo
    • Tema: (dejar vacío)
  3. Haga clic en Done

5.3 Configurar Nodo Function

El nodo Function formateará su mensaje saliente:

msg.payload = "Hello from OV20i camera";
return msg;

  1. Haga doble clic en el nodo Function
  2. Copie el código anterior en la pestaña "On Message"
  3. Nombre: "Format Message" → Traducción: "Formato de Mensaje"
  4. Haga clic en Done

5.4 Conectar las Nodos

Conecte los nodos en este orden:

Flujo saliente:

  • Inject → Function → TCP Out
  • Function → Debug (para ver los mensajes salientes)

Flujo entrante:

  • TCP In → Debug (para ver los mensajes entrantes)

5.5 Estructura del Flujo Completo

Su flujo final debe incluir:

  • Inject conectado a Function
  • Function conectado a tanto TCP Out como Debug
  • TCP In conectado a un nodo Debug separado

Resultado: Puede enviar mensajes haciendo clic en el botón Inject y ver tanto los mensajes salientes como entrantes en el panel de depuración.

Paso 6: Configurar Formato de Mensaje

6.1 Definir Formato de Mensaje

Mantenga la estructura del mensaje simple:

Tipo de MensajeFormatoEjemplo
Texto simpleCadena de texto"Hola desde la cámara"
Actualizaciones de estadoTexto con información"STATUS: READY"
Valores de datosFormato clave-valor"TEMPERATURE: 25.5"

6.2 Ejemplos de mensajes personalizados

Puede modificar el nodo de función para diferentes tipos de mensajes:

Mensaje de estado simple:

msg.payload = "Camera Ready";
return msg;

Mensaje con marca de tiempo:

msg.payload = "Time: " + new Date().toLocaleString();
return msg;

Datos con valores:

msg.payload = "INSPECTION_COUNT: 42";
return msg;

Paso 7: Despliegue y prueba de la configuración

7.1 Despliegue del flujo de Node-RED

  1. Haga clic en el botón Deploy (esquina superior derecha)
  2. Verificar el mensaje de éxito de la implementación
  3. Verifique los indicadores de estado de los nodos:
    • Punto verde: Conectado con éxito
    • Punto rojo: Error de conexión
    • Punto amarillo: Intentando conexión

7.2 Prueba de comunicación TCP

7.2.1 Prueba de conectividad básica

Usando herramientas de línea de comandos:

# Test TCP connection (Linux/Mac)
telnet [camera-ip] [port]
# Example: telnet 192.168.0.100 49155

# Test with netcat
nc [camera-ip] [port]
# Example: nc 192.168.0.100 49155

Windows PowerShell:

Test-NetConnection -ComputerName 192.168.0.100 -Port 49155

7.2.2 Envío de mensajes de prueba

  1. Conéctese al puerto TCP de la cámara
  2. Envíe comandos de prueba:
    • "STATUS" → Debería recibir una respuesta de estado
    • "TRIGGER" → Debería activar la inspección
    • "INVALID" → Debería manejar un comando desconocido

7.2.3 Supervisar la salida de depuración

  1. Abrir el panel de depuración de Node-RED (barra lateral derecha)
  2. Enviar mensajes de prueba vía TCP
  3. Verificar que la salida de depuración muestre:
    • Mensajes entrantes
    • Resultados del procesamiento
    • Respuestas salientes

7.3 Lista de verificación de validación

PruebaResultado esperadoEstado
Conexión TCPConexión exitosa al puerto de la cámara
Recepción de mensajesLa depuración muestra mensajes entrantes
Procesamiento de mensajesEl nodo de función procesa correctamente
Envío de respuestasEl dispositivo de destino recibe las respuestas
Manejo de erroresLos mensajes inválidos se manejan de forma adecuada

Paso 8: Integración con el sistema de inspección

8.1 Conectarse a disparadores de inspección

Vincular la comunicación TCP con el flujo de inspección:

  1. Agregar nodo "All Block Outputs" (si no está presente)
  2. Conectar los resultados de inspección a la salida TCP
  3. Formatear los datos de inspección para la transmisión TCP

8.2 Integración de datos de inspección

Nodo de función para procesar los resultados de inspección:

// Get inspection results from All Block Outputs
const results = msg.payload;

// Extract key information
const inspectionSummary = {
result: results.pass ? "PASS" : "FAIL",
timestamp: new Date().toISOString(),
processing_time: results.processing_time,
roi_count: results.roi_results ? results.roi_results.length : 0
};

// Format for TCP transmission
msg.payload = JSON.stringify(inspectionSummary);
return msg;

8.3 Control bidireccional

Habilitar control remoto vía TCP:

// Handle remote commands
const command = msg.payload.toString().toUpperCase();

switch(command) {
case "START_INSPECTION":
// Trigger inspection sequence
global.set("trigger_inspection", true);
msg.payload = "INSPECTION_STARTED";
break;

case "STOP_INSPECTION":
// Stop inspection sequence
global.set("trigger_inspection", false);
msg.payload = "INSPECTION_STOPPED";
break;

case "CHANGE_RECIPE":
// Recipe change logic
msg.payload = "RECIPE_CHANGED";
break;
}

return msg;

Paso 9: Solución de Problemas Comunes

9.1 Problemas de Conexión

ProblemaSíntomasSolución
No se puede conectarIndicador de estado rojoVerifique la dirección IP y el puerto
Caídas de la conexiónEstado amarillo intermitenteVerifique la estabilidad de la red
Errores de tiempo de esperaRespuestas tardíasAjuste la configuración de tiempo de espera
Conflictos de puertosConexión rechazadaUtilice un número de puerto diferente

9.2 Problemas de Transmisión de Datos

ProblemaSíntomasSolución
No se reciben datosEl depurador muestra mensajes vacíosVerifique la configuración de formato de datos
Datos corruptosTexto ilegible en depuraciónVerifique la codificación (UTF-8/Buffer)
Pérdida de mensajesFaltan mensajesVerifique la estabilidad de la red
Problemas con mensajes grandesDatos truncadosUtilice mensajes más cortos

9.3 Técnicas de Depuración

Solución de problemas sistemática:

  1. Habilite los nodos de depuración en cada paso
  2. Monitoree los registros de Node-RED para errores
  3. Pruebe primero con clientes TCP simples
  4. Verifique la conectividad de red con ping

¡Éxito! Su comunicación TCP está lista

Su sistema de comunicación TCP puede ahora:

  • Enviar y recibir datos entre la cámara y dispositivos externos
  • Procesar mensajes simples para una comunicación básica
  • Monitorear el flujo de datos con nodos de depuración
  • Manejar la comunicación básica de red para sus aplicaciones

Mantenimiento continuo

Revisión regular del sistema

  • Monitorear la estabilidad de la conexión a lo largo del tiempo
  • Verificar que la transmisión de datos funcione de forma constante
  • Verificar los registros de depuración para patrones de error
  • Probar la comunicación después de cambios en la red

Próximos pasos

Después de configurar la comunicación TCP básica:

  1. Pruebe con sus sistemas externos utilizando la conexión establecida
  2. Personalice los formatos de mensajes para sus necesidades específicas
  3. Agregue lógica más compleja a medida que crezcan sus requisitos
  4. Considere otros métodos de comunicación si TCP no satisface todas sus necesidades

🔗 Ver También

For high-throughput applications:

  1. Reducir la frecuencia de mensajes
  2. Agrupar múltiples mensajes
  3. Usar formato binario para datos grandes
  4. Implementar compresión

Técnicas de Depuración

Solución de problemas sistemática:

  1. Habilite nodos de depuración en cada paso
  2. Monitoree los registros de Node-RED para errores
  3. Use herramientas de monitoreo de red (Wireshark)
  4. Pruebe primero con clientes TCP simples

¡Éxito! Su comunicación TCP está lista

  • Enviar y recibir datos entre la cámara y dispositivos externos
  • Procesar comandos para control remoto
  • Transmitir resultados de inspección en tiempo real
  • Manejar errores de forma adecuada con un manejo correcto de errores
  • Integrar con sistemas de producción para flujos de trabajo automatizados

Mantenimiento Continuo

Revisiones del Sistema Regulares

  • Monitorear la estabilidad de la conexión a lo largo del tiempo
  • Verificar la integridad de los datos en producción
  • Actualizar las configuraciones de seguridad según sea necesario
  • Optimizar el rendimiento según los patrones de uso

Monitoreo del Rendimiento

  • Rastrear el rendimiento de mensajes y la latencia
  • Monitorear las tasas de error y fallos de conexión
  • Analizar patrones de datos para oportunidades de optimización

Próximos Pasos

Después de configurar la comunicación TCP:

  1. Integrar con sus sistemas externos usando el protocolo establecido
  2. Implementar manejo de errores integral para uso en producción
  3. Configurar registro y monitoreo para la salud del sistema
  4. Considerar mejoras de seguridad para el despliegue en producción

🔗 Véase También